Obtains the current setting of a control.

SInt32 GetControl32BitValue (
    ControlRef theControl
);

theControl

A handle to the control whose current setting you wish to obtain.

function result

The current setting of the control.0

DISCUSSION

Your application may use the GetControl32BitValue function to obtain a 32-bit value previously set with the function SetControl32BitValue.

If your application uses a 32-bit control value, it should not attempt to obtain this value by calling the pre–Mac OS 8.5 function GetControlValue or by accessing the contrlValue field of the ControlRecord structure, because the stored 16-bit value will not accurately reflect the current 32-bit control value.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)